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Issue #4, 1995 



About the MOTD 



MOTD Information 

The OS-9 Users Group, Inc. is a not-for-profit organiza- 
tion, registered and incorporated in the state of Iowa, 
whose members share an interest in the OS-9 operating 
system in all of its various forms. 



MOTD is the official 
Group, Inc. 



newsletter of the OS-9 Users 



The OS-9 Users Group, Inc. has no affiliation with 
Microware or any other organization. 

The opinions expressed by the authors of any articles or 
columns are not necessarily the opinions of the Editor, 
Publisher, columnist, nor do they reflect the policies of 
The OS-9 Users Group, Inc. 

The MOTD will be printed a minimum of four times per 
year. 

To receive MOTD you must be a member in good stand- 
ing of The OS-9 Users Group, Inc. in accordance with 
the bylaws. 

To become a member in good standing you must pay the 
yearly dues of $25.00 US funds ($30.00 US funds if you 
live outside the US and Canada) and obey all of the 
membership rules set forth in the Constitution of The 
Users Group and the bylaws. 

Dues should be made payable to: 



The OS-9 Users Group, Inc. 
6158 West 63rd Street 
Suite 109 
Chicago, II. 60638 
U,S,A. 



Memberships run for one year from the date received by 
the Users Group. Send a SASE for a membership kit 
which will include a membership form and information 
about the Users Group. 

Please remember that this is a self help organization, and 
also a non-profit organization incorporated in the state of 
Iowa and as such it is directly governed by the laws of 
that state as well as all federal laws. Accordingly, dues 
are non-refundable in accordance with both state and 
federal law. 

Reprints or back issues of the MOTD are available to 
members in good standing at the cost of $1.50 each plus 
$0.50 shipping (US funds). Please send a SASE and a 
list of the issues you wish sent to you. 



Here is a list of the current OS-9 Users Group officers: 



Position 


Name 


President 


Colin McKay 


Executive Vice Pres. 


David Graham 


Director 


Ed Gresick 


Director 


Eddie Kuns 


Director 


Ken Scales 


Vice Pres. (Comm.) 


Paul Jerkatis 


Vice Pres. (OS-9) 


Brian Goers 


Vice Pres. (OS-9/6809) 


Mike Rowen 


Secretary 


Howard Luc key 


Treasurer 


Br. Jeremy 


Librarian 


Dave Kelly 


MOTD Editor 


Joel Mathew Hegberg 



MOTD Contributions 

Articles, editorials, "letters to the Editor/Board of Direc- 
tors", personal ads, graphics, or columns may be submit- 
ted by using the following means: 

E-mail to JoelHegberg@delphi.com, E-mail to 'Sysop' 
of SandV BBS [(708) 352-0948], E-mail to the OS-9 
Users Group at os9ug@sandv.chi.il.us or by mail to The 
OS-9 Users Group address in Chicago. All submissions 
should be in pure ASCII format. 

The submission of material does not guarantee publica- 
tion. All publication of material is subject to review by 
the Board of Directors and the MOTD Editor, and must 
not be in conflict with the stated purposes of the Users 
Group as defined by the constitution and bylaws of the 
Users Group. The Board of Directors may also establish 
additional guidelines for acceptance to publication. Sub- 
mission deadlines are four weeks before actual printing 
of the MOTD issue. All printed material is subject to 
nominal editing by the MOTD Editor for clarity. 

Suggestions for making MOTD a better publication are 
welcome. Letters may be addressed to the MOTD Edi- 
tor and mailed to the Users Group address or sent 
directly to JoelHegberg@delphi.com. E-Mail can also 
be sent to the following Delphi members: NIMITZ, 
MITHELEN, LUCKYONE, BRIANGOERS, 

EDDIEKUNS, EDELMAR, MROWEN, REVWCP, and 
KSCALES. You may also sent E-mail to 
os9ug@sandv.chi.il. us. 

MOTD Advertising 

Commercial advertising is available in MOTD. Please 
send a SASE for current rates. All ads should be submit- 
ted as a camera-ready copy. We reserve the right to limit 
the size and quantity of ads. 

SandV BBS (708)352-0948 

The SandV BBS is a BBS being maintained by Paul Jer- 
katis to provide Internet access. 
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From the President 



First, thanks to all of you for the feedback about the 9503 
issue. A few delays in getting it out, but I think that the 
end results were worthwhile. This issue gets us almost 
back on schedule for the year, and the next two issues will 
follow in October (with an Atlanta Fest report), and in 
early December. Everybody liked the new format, though 
there were a few problems with photocopying dark areas 
which we hope to improve upon. That issue was mailed 
from Canada, but now that Joel has completed his move 
mailing from the US (cheaper postage) has resumed. 

Atlanta Fest 

As mentioned in the last issue, the Atlanta Fest is 
approaching quickly, 30 September to 1 October! See the 
ad below for more details. Should be lots of interesting 
stuff to see there, along with the laser light show at Stone 
Mountain, and a chance to meet fellow OS-9 enthusiasts. 

UG Library 

The OS-9 Community Network should have the com- 
plete UG library by the time you read this. The files will 
be reorganized in accordance with OCN's filing system. 
See the OCN article in the 9503 issue for details. Once 
things get organized, we will begin publishing the com- 
plete OCN library listing in the MOTD over a period of 
several months. 



MIT Sea Grant College Program 

In the September 1995 issue of Popular Science, on page 
26, is an article about a Robot Lobster which is used to 
follow chemical plumes. Those of you who follow the 
SFTHM column may recall that the lobster was men- 
tioned in the May/June 1994 issue of the MOTD, in the 
SFTHM column about the Sea Grant Programs Autono- 
mous Underwater Vehicle, which was controlled using 
OS-9. 

Programming with Solder 

This new column will appear from time to time as mate- 
rial is available. Primarily, I expect, it will consist of 
hardware projects for the Color Computer, though sub- 
missions for other hardware that uses OS-9 are very 
welcome. Skill level required for assembling these 
projects will vary with the project. 

Submissions and Upcoming Articles 

Submissions, as always, are welcome. Just send it by 
email or snail mail to the MOTD Editor at any of the 
Users Group addresses. 

Colin McKay 
President 



r 



6th Annual Atlanta CoCoFest 1995 

Holiday Inn, Northlake 
Thicker, GA (Atlanta area) 

Show Hours: 




Sat. Sep 30 9:00 AM - 5:00 PM 

Sun. Oct 1 9:00 AM - 3:00 PM 



Vendor Setup: 



Fri. Sep 29 6:00 PM - 9:00 PM 
Sat. Sep 30 8:00 - 8:45 AM 

Admission: 

$10.00 (Whole show) 

Reservations: 

Holiday Inn, Northlake 
800-465-4329 or 404-938-1026 

Sponsored by: 

Atlanta Conputer Society 
PO Bos 80694 
Atlanta, GA 30366 
BBS: 404-636-2991 
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Minutes for Board of Directors Meeting July 5, 1995 



A regular meeting of the OS-9 Users Group Board of 
Directors (BOD) was called to order at 7:51 PM CT on 
July 05, 1995 on Delphi. Present: Colin McKay, president 
and chairman of the Board, directors-at- large Ed Gresick, 
and Eddie Kuns. Present as invited guests: Howard 
Luckey, secretary, Mike Rowen, VP-6809, Joel Hegberg, 
editor of MOTD, and Boisy Pitre, member. 

The first order of business was the approval of the minutes 
of the last regular meeting of the BOD held on 03 May 
1995. Minutes approved as presented. 

The second order of business was the treasurer's report. A 
report by Brother Jeremy showing deposits and withdraw- 
als for the month of May was accepted and approved. 

OLD BUSINESS: 

Item 1. Vendor's package: 

Colin has a form he is using and will send a copy to Ed for 

his comments. 



Resolution postponed. 

Item 5. MOTD: 

Latest issue should be in the mail soon. 

Item 6. Library status: 

Dave Kelly from OCN has agreed to serve as UG librar- 
ian. Arrangements were made to mail our library to him. 

Item 7. Atlanta Fest: 

The President reported that the Atlanta Computer Society 

has agreed to swap booth space for ads in the MOTD. 

The BOD returned to the discussion of item 2 of old busi- 
ness, Joel's clipboard. One question is whether the UG 
through the BOD should endorse things or just announce 
that things are available. The issue is not the Clipboard 
itself but the related issue of standards and how much the 
UG should or should not set them. The BOD has asked 
Brian Goers, VP-OSK, to chair a committee to get things 
started. 



Item 2. Joel Hegberg's proposed OS-9 Clipboard 

Standard: 

Skipped for later discussion during the meeting. 

Item 3. Letter of appreciation: 

The President reported that a letter of appreciation had 
been sent to Kurt Johnson of KD Consulting for his sem- 
inar on Sculptor presented at the last Chicago Fest. 

Item 4. Presidential spending: 

This is a proposal to establish a Board policy that would 

limit the amount the president can spend without Board 

approval to $100.00. Presently are there no limits on 

spending other than the discretion of the President and the 

Treasurer. 



NEW BUSINESS: 

Item 1. OS-9 Scholarship: 

Boisy Pitre has suggested that the UG offer a scholarship. 
After some discussion a committee made up of Boisy, 
chair, Ed Gresick, and Joel Hegberg was formed to work 
out final details for the scholarship. Some of the details 
include: tax status of the UG so that contributions can be 
tax deductible, qualifications to receive the scholarship, 
publicizing the program, etc. No formal Board action was 
taken. 

The meeting adjourned at 8:55PM. 

Howard Luckey, Secretary 
Tuesday July 25, 1995 



These minutes were approved as read at the September 6, 1995 meeting of the Board of Directors. 



OS-9 WWW Home Page 

http: //www. wisc.edu/~pruyne /os 9faq.html 

Users Group WWW Home Page 

http://www.wisc.edu/~pruyne/os9ugfaq.html 
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OS-9 Online Conference Schedules 



DELPHI OS-9 Late Night Conferences with Chris Perrault 



Monday, 18 Sep 95 - 10PM ET 
Monday, 2 5 Sep 95 - 10PM ET 



Upcoming Atlanta Fest 

KD Consulting discusses Sculptor database 



GENIE CoCo Real Time Conferences 

Every Sunday - Open discussion forum 9 -10PM ET 



OS-9 IRC Conferences 



Sunday, 10 Sep 95 
Sunday, 24 Sep 95 



10PM ET {GMT 
10PM ET (GMT 



4) : OS-9 Users Group projects 
4 ) : Open Forum 



Conferences are held every second Sunday at this same time. 
Type /join #os9 once inside IRC. 

Are there any other on-line conferences happening out there? If you know of other conferences or events that 
are taking place on other on-line services (AOL, Genie, CIS, etc.) please send mail to me at either address listed 
below. I will post any information I receive: 

Mike Rowen 
VP OS-9/6809 
OS-9 Users Group 
mrowen01@delphi . com 



f OS-9 Periodical List 




Compiled by Ed Jones 


MAGAZINES 


PUBLISHER 


PRICE 


ADDRESS 


the world of 68' micros 


Frank Swygert 


$25.00 USA 
$32.00 Canada 
(8 issues; one year) 


Farna Systems 

PO Box 321 

Warner Robins, G A 3 1 099-032 1 

(912)328-7859 (voice) 


MicroDisk 


Farna Systems 


$40.00 USA 
$44.00 Canada 


(See 68' Micros above) 


OS-9 International 


European Forum for OS-9 


Swiss Francs for one year 
(three issues): 
Switzerland: 25.00 
Europe: 30.00 
Overseas: 35.00 


EFFO, 

PO Box CH-8606 

Greifensee, Switzerland 

(os9int@effo.ch) 


Nine Times 


JWT Enterprises 


$34.95 USA 
$35.95 Canada 
(6 issues; one year) 


JWT Enterprises 
5755 Lockwood Blvd. 
Youngstown, OH, 445 1 2 
(216)758-7694 (voice) 


MOTD 


OS-9 Users Group Inc. 


$25.00 USA and 
Canada 
$30.00 others 


OS-9 Users Group, Inc. 

6158 West 63rd Street 

Suite #109, Chicago, IL 60638 


OS-9 Newsletter 


Bellingham OS-9 UG 


$10 (12 issues) 


OS-9 Newsletter 
3404 Illinois Ln 
Bellingham, WA 98226-4238 


CoCo 1-2-3 


Glenside CoCo Club 


$15.00 USA 


Glenside CoCo Club 
RR #2, Box 67 
Forrest, IL 61741-9629 
(708)428-3576 (voice) 
(708)428-0436 (BBS) 
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Straight From the Horse's Mouth 



bv Colin McKay 



The following article contains highlights from the OS-9 
DAVID (Digital Audio/Video Interactive Decoder) Con- 
ference held on Delphi, 31 July 1995. Permission has 
been granted by the participants for reproduction in the 
OS-9 Users Group newsletter, and posting to Internet 
newsgroups. 

The Conference was hosted by David Kimble from 
Microware Systems Corp in Des Moines, Iowa. David 
was speaking for himself during this conference, not as 
an official Microware representative. Thanks also to 
Chris Perrault for arranging the conference. This text was 
heavily edited for brevity and clarity, so my apologies for 
any errors that may have been introduced. 

The transcript includes comments from the following 
participants: 

DKIMBLE: David Kimble (special guest host) 

Chris: Chris Perrault (organizer) 

JOELHEGBERG: Joel Hegberg 

Hugo: Hugo Bueno 

HAWKSOFT: Chris Hawks 

Mike_Rowen: Mike Rowen 

Colin: Colin McKay 

Boisy: Boisy Pitre 

jb: John Baer 

DOMM: Domenick Mirando 
This is not a complete list of attendees, of course; it only 
includes those who made comments captured in the 
transcript. 



OS-9 DAVID Conference 
Held on Delphi, 31 July 1995 

Chris> David, please give us a bit of a summary of 
DAVID for those not familiar with it. 

DKIMBLE> OK, I'll start with a little history as to how 
Microware came to be in the interactive TV game. When 
I'm done I'll take any questions. 

As you may know, Sony and Philips came to us back in 
the mid-80's wanting to create this new generation of 
consumer electronics that they would call CD-i. They 
needed a real-time operating system that didn't need 4mb 
to run in and had a chance of running for some period of 
time without having to press CTL- ALT-DEL. :) 

They approached Microware, and CD-RTOS was born. 
CD-RTOS is nothing but OS9 as everyone knows it, with 
a few new I/O subsystems thrown in. Primarily CD sup- 
port, which introduced the concept of asynchronous I/O. 
(You do a read call, it returns immediately, you get sig- 
nals telling you how the read is doing.) 



The other I/O subsystem that was new was the MPEG full 
motion video support. This was all nice and cool and 
everyone was happy in Des Moines. 

Then along came the Telcos with beaucoup bucks saying 
they want to do this thing called Interactive TV (ITV). 
Never mind what the hell it is, they just know they have to 
have it. 

So we (Microware) thought, "hmnT. This ITV is pretty 
close to this CD-i problem we already solved. In fact, if 
you pretend that at the other end of this long telephone 
cable, the phone company had nothing but a CD device, it 
was almost identical. So, thanks to our good advice to the 
phone companies, the first generation of ITV boxes looked 
one hell of a lot like CD-i players with a remote CD. They 
had 68k CPUS, they had CD-i graphics chips (MCD21 1 & 
212), and they had MPEG chips similar to the ones in the 
CD-i video cartridges. 

The three main problems to solve were: 

1) the MPEG chips chosen were slightly different, requir- 
ing some driver work; 

2) the paradigm of a CD had to be abstracted to a network; 
and 

3) no one had done this before (or understood all that was 
involved). 

DKIMBLE> So, that first generation worked out pretty 
well... IBM had a division in NY that made set-top boxes, 
and another company, Adaptive Microware (no relation) 
made them as well. They were what came to be called 
ADSL boxes. ADSL is approximately Asymetrical Digital 
Subscriber Line. It allowed (as long as you had fiber within 
18000 feet of your home) for the Tl video pipe (1.5MB 
downstream - notice the data rate is lxCD), the X.25 con- 
trol channel (two-way 16kb), and the POTS (plain old 
telephone service) to all be multiplexed together on stan- 
dard phone wires! This was fine, and actually worked 
pretty well on the set-top. Of course, the network was a lit- 
tle more complicated than that and things developed 
slower than anticipated. 

None of what the telcos were trying to do had been done 
before. The old pioneers getting the arrows in the back 
applies here. They were also hampered by the fact that reg- 
ulation in these good ole United States is less than 
favorable if you're a phone company. Particularly when 
this started (1982-83), there was some fear about what the 
government types would do when the phone companies 
started delivering video. 

Well, there are now trials going on across the world: Hong 
Kong, Japan, Italy, and the UK, with more planned: 
France, Singapore, Sweden, Germany, Canada, and more. 
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Straight From the Horse's Mouth 



by Colin McKay 



The ADSL model is losing favor, in favor of pure digital 
networks (ATM primarily). The next generation of boxes 
have some other nice things as well: MPEG2 decoders, 
PPC CPU's, more interesting gfx chips. 

Our work continues to be that of helping the network 
operators determine what they really need (vs. what they 
sometimes want), and helping set-top manufacturers port 
all of the I/O drivers to their boxes, and making sure that 
the server people all talk a language that all of the boxes 
can understand (eg. DSM-CC). 

There are a lot of cool things planned for this technology, 
but there are so many components that the end-to-end net- 
work is taking longer to come up than originally planned. 

The OS works, however :), and we are trying our best to 
bring the rest of the players up to where we can turn on a 
real network. Toms River, NJ looks to be the first real 
end-to-end interactive network - due to come online in 
less than a month. It will have Philips STBs, a BroadBand 
Tech (BBT) network, and OS9/DAVID running in the 
boxes. 

JOELHEGBERG> (STB = set top box) 

DKIMBLE> DAVID is to ITV what CD-RTOS is (was) 
to CD-i. A particular combination of I/O subsystems 



required to do ITV. 

HAWKSOFT> Was? 

DKIMBLE> Not really was... that was a side-ways refer- 
ence to my disappointment at the popularity of CD-i... 

DKIMBLE> Any questions? 

Chris> Is the MPFM which I read about in an issue of 
Pipelines a couple of years ago part of the ITV and CD-I 
systems? 

DKIMBLE> yes, the original MPFM (MPEG file man- 
ager) was designed to be compatible with the original spec 
of Philips. The most recent incarnation deviates for the 
first time from the "green book" (the CD-i spec). There 
were a number of things about the original implementa- 
tion that were not, how shall I say, the best approach. 

Hugo how does HDTV fit into all this? 

DKIMBLE> Well, from OS9's point of view, it's just 
another set of h/w to write drivers for (encoders, gfx chips, 
etc.). It will be important to us when a network provider 
specifies that they want HDTV in their network. It will 
require higher bandwidth networks (30 frames/sec at 
much higher resolution), but those are coming now. 



We started by listening to the needs expressed by you, our customers. 

You wanted a machine with expandability - 
We gave you up to 5 16 bit ISA Bus slots. 

You asked for fast serial ports - 

We gave you 2 onboard 16550 ports with speed up to 1 15K baud. 

You asked for cheap, easy to install hard drives - 
We gave you an onboard controller for 2 IDE hard drives. 

You asked for the ability to read a wide variety of floppy formats - 
We gave you the ability to use 3.5 inch drives storing up to 2.88 megabytes. 

You asked for the latest in Real Time Operating Technology - 
We gave you OS9 Version 3.0 - the proven product of Microware Systems Corp. 

You asked for a base price that was less than the total cost of the 
included software - 
We gave it to you. 

For more information about products from a partnership of companies committed to filling 
your computing needs, call : 

BlackHawk Enterprises, Inc. 

P.O. Box 10552 

Enid, OK 73706-0552 

(405) 234-2347 
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Mike_Rowen> Do you envision cable providers taking 
the first step instead of telcos? 

DKIMBLE> Well, cable providers are not as far along as 
telcos are and they are not as rich. They also suffer from 
customer perception that they have been less than.... I 
don't know the word, but that they have lousy service :) 

Mike_Rowen> :) 

HAWKSOFT> 500 channels and nuthin on! 

DKIMBLE> There are a large number of folks that are 
ready for the telcos (come home to ma bell) to take over 
their ITV. 

Mike_Rowen> Will the new CD format rivalry impact 
things for Micro ware? 

DKIMBLE> The new CD format rivalry means extra 
drivers, that's all... 

Mike_Rowen> That's good to hear. 

DKIMBLE> The beauty of where we sit is that every- 
thing is Legos (tm) i.e. a new h/w component has very 
little influence on the rest of the system (data rates are 
really the biggest impact). 

Colin> When can the consumer expect to actually start 
seeing these things, both in the US and in Canada? 

DKIMBLE> When can we expect to start seeing things? 
Good question. There are currently 20 companies build- 
ing DAVID boxes. There are all sorts of networks being 
built. It will be a number of years (4-5) until these things 
are all over. 

Colin> Thanks. Any idea of the cost? 

DKIMBLE> Hah! Depends on who you ask. There are 
those that say they want a PPC CPU, 8MB RAM, a $250 
network interface module (NIM), and a toaster on the 
side... 

Chris> How much for the toaster? <G> 

DKIMBLE> Then there are those that want it to be 
<$300. Those two groups never seem to go to lunch 
together. :) 

JOELHEGBERG> :) 

Chris> Will the end user have to change anything in his 
hardware, ie: Better television upgrades etc? 



DKIMBLE> About the h/w, we are trying very hard to 
convince manufacturers to build things so that they will be 
more network independent, i.e. the first thing you do on a 
network is download the protocol stack for that network. In 
terms of TV resolution, the current boxes all put out NTSC 
(normal North American TV) resolution, so there is no 
special requirement. 

Mike_Rowen> What kinds of interactive services are 
being offered and from what hosts? 

DKIMBLE> The current idea is that MMDS (lower-end) 
services will be the first real implementation, and those 
boxes can actually be built for $300. 

Hugo> MMDS? 

DKIMBLE> Multi-channel, Multi-point, D<something>, 
S<something>. It's a wireless network, using line-of-sight 
microwave antennae/receivers. The current back channel 
will be a modem, kind of like the RCA stuff does now 

Hugo What exactly does ITV provide? 

DKIMBLE> What can you do <big voice>: "I'm glad you 
asked that question, son."... 

JOELHEGBERG> ;) 

DKIMBLE> There are plans to do interactive shopping, 
Video on demand (movies when you want them), net- 
worked games, let's see..., on-line banking... Electric 
Program Guides (while you're watching TV, you have 
access to TV-guide like info on line). 

JOELHEGBERG> Don't forget Karaoke, Dave! 

DKIMBLE> Oh yes, karaoke! Microware is currently 
developing an algorithm to randomly play a video with 
karaoke audio and guarantee that they have nothing in 
common...:) 

jb>heh! 

Boisy> I know, I've seen it. :) 

Colin> Oh, you mean a Microsoft 1.0 Release. 

JOELHEGBERG> ooooh.. :) 

Chris> LOL 

DKIMBLE> There are people working on Interactive TV, 

as in play along with Jeopardy. 

Hugo> Can personal computers be hooked up to the 
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"wire"? 



pushing the envelope. 



JOELHEGBERG> Make sure that's in the log. 
HAWKSOFT>YEAH!!! 

Chris> Yeah, can we hit the homepages with our tv's? 



DKIMBLE> Personal computers can certainly, as long as jb> DSS is nice, but not interactive <g>. 

they're running OS9 <G>... 

JOELHEGBERG> I think Microware's solution is the 
most mature in the market, however. 

Chris> and it sounds like a natural fit 

Mike_Rowen> I work for EDS and they are interested in 
the supply side of things. Have you worked with them? 
DKIMBLE> There are people right now putting a DAVID 

box on a PC board. There are people right now also writ- DKIMBLE> We have talked with all sorts of people, 
ing HTML interpreters to netsurf from your couch... (god There will be a place for the types of services that EDS has 
help us reading text on a TV). I saw one presentation to offer. Right about DSS, and that's the thing -it has flash, 
where they had mocked up a Jeopardy game where you people are impressed to see digital video for the first time, 
played along with the real contestants. If you get a good It's just MPEG1 video being delivered by satellite. As 
enough score at the end of the game, the sponsor sends Joel said, it's really not as mature as what currently exists 
you a nice package. using OS9, but it's taking longer to get the more compli- 

cated networks on line. 
Hugo> I just hope the content won't be more of the same 
fluff we get now. jb> Yep! Got to build those. 

DKIMBLE> I am not all that encouraged in this regard... DOMM> If one had to choose now between hooking up 

with cable or RCA...??? 
Hugo Another bothersome thought is that perhaps the 
providers will be able to monitor people's watching habits. Hugo> Domm, I would choose neither :-) 

DKIMBLE> The people who will decide what goes on DKIMBLE> DSS is not cheap. Cable has the physical 

these networks will be the ones who are spending and plant too, giving them an edge price- wise. 

making the $. Yeah, there is an element of paranoia that is 

probably healthy. DKIMBLE> I need to wrap up soon. Any other questions? 

Chris> Do you expect a lot of exposure once a succesful Hugo> Thanks for stopping by David, it was interesting! 
network is established in Toms River (the test site selected 



by Bell Atlantic)? 

DKIMBLE> Toms River will certainly create some head- 
lines. It remains to be seen what the "spin" will be. 

DOMM> How long is the Toms River experiment sup- 
posed to last? 



JOELHEGBERG> Anyone with one more question for 
Dave? 

Mike_Rowen> Great conference. Appreciate your time 
David. 

jb> I'll second that! 



DKIMBLE> Not sure about that. If it goes bad, probably DKIMBLE> Glad to preach the gospel of OS9 <G> 
not long <G>. 



Chris> Is 'Modular Windows' completely out of the pic- 
ture or is Microsoft still sticking its foot in the door? 

Hugo> There must be competition out there. RCA DSS is 
one, what are the others? 



JOELHEGBERG> Yeah, this has been great... 

Chris> Thanks for your insights Dave. This topic defi- 
nately lived up to it's expectations! 

DKIMBLE> it's fun work, I like talking about it. 



DKJMBLE> Microsoft is still in the game — when some- JOELHEGBERG> Glad you set it up, Chris, and glad you 

thing is that big, everyone keeps an eye on it. They are could come, Dave! 

proposing an end-to-end Microsoft solution that has some 

people getting deja-vu. RCA DSS is the big one, they're DKIMBLE> my pleasure! 
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Vendor 
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Phone 


AniMajik Productions 


4650 Cahuenga Blvd, Ste #7, 
TOLUCALAKE CA 91602 


(818)-769-1938 


Ark Systems USA 


PO Box 23, 

SANTA CLARA CA 95052 


(408)-244-5358 


* Blackhawk Enterprises 


PO Box 10552, 

ENID OK 73706-0552 


(405)-234-2347 


* Bob van der Poel Software 


PO Box 355, 

PORTHILL ID 83853-0355 


(604)-866-5772 


Computer Design Lab 


RR1 Box 36, 
RHINELAND MO 65069 


(314)-236-4373 


Computer Design Services 


2550 Sandy Plains Rd, 
MARIETTA GA 30066 


(404)-973-2170 


CoNect 


449 South 90th St, 
MILWAUKEE WI 53214 


(414)-258-2989 


* Delmar Co 


PO Box 78, 5238 Summit Bridge Rd, 
MIDDLETON DE 19709 


(302)-378-2555 


Disto 


1710Depatie, 

ST LAURENT QC H4L4A8, Canada 


(514)-744-7777 


Farna Systems 


PO Box 321, 

WARNER ROBINS GA 31099-0321 


(912)-328-7859 


Frank Hogg Laboratory 


204 Windemere Rd, 
SYRACUSE NY 13205 


(315H69-7364 


Gale Force Enterprises 


P.O. Box 631, Surrey Main, 
SURREY BC V3T 5L9, Canada 




* Hawksoft 


244 S Randall Rd, 
ELGIN IL 60123 


(708)-742-3084 


The KD Consulting Group, Inc. 


5768 Fairridge Lane 
HAMILTON OH 45011 


(800)-837-1619 


KEN-TON 


Contact Farna Systems 




Microware Systems Corporation 


1900 NW 114th St, 
DES MOINES IA 50322 


(515)-224-1929 


* Northern Xposure 


7 Greenboro Cres, 

OTTAWA ON KIT 1W6, Canada 


(613)-736-0329 


Peripheral Technologies 


1480 Terrell Mill Rd #870, 
MARIETTA GA 30067 


(404)-973-2156 


RemComs 


100 Whitsunday Dr, 

KIRWAN QLD 48 1 7, Australia 


+61 77 734884 


Sub-Etha Software 


PO Box 152442, 
LUFKIN TX 75915 




Windsor Consulting Group 


2014 Cherokee Pkwy, Suite J, 
LOUISVILLE KY 40204 


(502)-454-0054 


* Wittman Computer Products 


7376 North Bergen Rd, 
BERGEN NY 14416 


(716)-494-1506 



* Indicates corporate member of the OS-9 Users Group 
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A Basic09 Tutorial 



bv Bob Devries 



This article is a continuation of the Basic 09 tutorial by Bob Devries from 
Australia* One or two articles from the series will appear each issue, 
depending on space. (Real Queen's English spelling mode enabled — ) 



Part 3 of 14 

Listing 1 is the BASIC code for the numbersquare pro- 
gramme from 'Microcomputing', June 1981. It is written 
in vanilla BASIC, but is suitable for Extended Colour 
Basic with minor modifications, in lines 140, 490, 760, 
920, 960 and 1450. Can you work out what to change? 
(Note please that a colon is used instead of a REM) 

The game is a fairly simple one based on the use of multi- 
dimensioned arrays. Note the use of colons at the begin- 
ning of REM lines, which is also possible in DECB. Now 
comes the tricky part, the conversion to Basic09. Firstly 
I'll show you the code as I rewrote it (Listing 2), then I 
will explain it. 

OK, so here we go. First, I used the command BASE 1. 
This is because all the arrays in the BASIC programme 
start at 1, and Basic09 usually starts at zero (actually, 
BASIC does too, but I see no reason to waste valuable 
memory). Next, I dimensioned all the variables and 
arrays, including a variable type which you may not have 
seen before, the BOOLEAN type. This variable may only 
contain either TRUE or FALSE! I used the SHELL com- 
mand to turn off the OS9 screen pause, so that the 
programme won't sit there waiting at what it thinks is the 
end of a screen. That can get a bit confusing! 

The next thing you must realise is that I have used NO 
LINE NUMBERS! This is really the best way to pro- 
gramme. Sure, Basic09 will allow their use, but the code 
is much more elegant without them, if a little more diffi- 
cult to write. I set up a loop to allow the choice of whether 
to play another game which is done in line 1450 in the 
BASIC version. I used a WHILE loop here so that all I 
need to do is make a variable FALSE to exit the loop. 

Next, after clearing the screen (printing a formfeed char- 
acter), I print the opening message and ask the player for 
his choice of game. This follows through to line 160 of 
the BASIC programme. On the basis of the player's 
answer I RUN either the procedure 'setupssb' or 'set- 
upmsb'. You may notice a slight variation here, I only 
tested for a T to select sequential, and any other key 
would run the magic square option. Then the next 38 lines 
do the same as lines 480 to 700 in the BASIC programme. 
You will notice that the BASIC programme uses quite a 
large number of GOTOs in this piece of code to break out 
of various parts of the code to continue the FOR-NEXT 
loop. I simply set a variable (lop) to TRUE and again 
used a WHILE loop. All the other variables have the 



same names, although you can of course use any name, and 
are not limited to two significant characters as in BASIC. 

To make the screen easier to display, I used in this case a 
gfx2 command 'cwarea'. This command limits the area of 
the screen to be printed to, and means I don't need to use 
cursor maneuvering code at every print line. I simply re- 
sized the screen to a 22 by 12 character box in approxi- 
mately the middle of the (80 by 24) screen. So next I print 
the scrambled array to the screen with one space so that 
pieces may be moved around. The game is played by enter- 
ing the number of the square which you want to move into 
the space. The programme checks to see if the number is 
one of the ones adjoining the space. A tone is sounded, and 
you are prompted for input. Pretty standard here, 'though I 
could just have used 'PRINT CHR$(7)', but the gfx2 'bell' 
command is nicer. If the player enters zero, the programme 
resets the screen back to its 80 by 24 size, and clears the 
screen and quits. 

The rest of the code is fairly straight forward, again the 
original uses many GOTOs to quit out of FOR-NEXT 
loops (not a good practice in my opinion, even in BASIC), 
and I have used boolean tests for this purpose. For every 
move made, the programme checks the array against the 
solution, and if the last move solves the puzzle, it prints the 
necessary result. 

One of the hardest parts of the conversion is keeping track 
of the variables, and the various loops. Basic09 is a bit 
unforgiving about 'UNMATCHED CONTROL STRUC- 
TURES' so you can't stop doing a conversion such as this 
in the middle, without generating a series of error mes- 
sages when you quit the editor. One way around this is to 
use a text editor (like VED or SCRED or SLED) to create 
the source code first, and then to load it into Basic09. The 
only thing you MUST do in this case is to make the word 
'PROCEDURE' in UPPERCASE the FIRST WORD in the 
file. The letter P of procedure must be the first character in 
the file, or Basic09 will not recognize it. 

OK, so there you have it. I would love to hear from you 
regarding your own trials and tribulations with Basic09 
programmes, even if you don't really want to start out on 
conversions of this type, but are having difficulties manag- 
ing some aspect of Basic09. Please write to me care of the 
newsletter editor, and let 'Professor Bob' help sharpen your 
programming skills. 

Regards, Bob Devries 
(bob@paxnet . com. au) 
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by Bob Devries 



0C1C 

02 G 

00 3 

0040 

0050 

0060 

0070 

0080 

0090 

0100 

0110 

0120 

0130 

0140 

0150 

0160 

0170 

0180 

0190 

0200 

0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0290 

0300 

0310 

0320 

0330 

0340 

0350 

0360 

0370 

0380 

0390 

0400 

0410 

0420 

0430 

0440 

0450 

0460 

0470 

0480 

0490 

0500 

0510 

0520 

0530 

0540 

0550 

0560 

0570 

0580 

0590 

0600 

0610 

0620 

0630 

0640 

0650 

0660 

0670 

0680 

0690 

0700 

0710 

0720 

0730 

0740 

0750 

0760 

0770 

0780 

0790 

0800 

0810 



: Number square game 
: ver 4.0 - 12 nov 79 
: Marc I. Leavey, M.D. 
LINE- 
DIGITS^ 



PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
INPUT 



"NUMBER SQUARES" 



WELCOME TO THE WORLD OF" 
CONFUSION. THERE ARE TWO" 
VERSIONS OF NUMBER SQUARES : ,( 

1 - SEQUENTIAL" 

2 - MAGIC SQUARE" 
WHICH IS YOUR PLEASURE" ,T 

IF T=l GOTO 310 
IF T<>2 GOTO 140 



SET UP MAGIC 
SQUARE BOARD 

FOR 1=1 TO 4 

FOR J=l TO 4 

READ M(I,J) 

LET B(I, J) =M<I, J) 

NEXT J 

NEXT I 

DATA 1,6, 15, 8, 12, 11, 2, 5, 10, 13,4, 3,7, 16, 9, 14 

LET 11=4 

LET Jl=2 

GOTO 44 

SET UP SEQUENTIAL 
BOARD 

DIM B(4,4) 

FOR 1=1 TO 4 

FOR J=l TO 4 

LET B(I, J) = (1-1) *4+J 

NEXT J 

NEXT I 

LET 11=4 

LET Jl=4 

NOW SCRAMBLE THE BOARD 
TWO HUNDRED TIMES 

PRINT "I AM NOW SCRAMBLING THE BOARD..." 

FOR Q=l TO 200 

LET M=INT(1+RND*4) 

ON M GOTO 510,560,610,660 

IF 11=1 GOTO 490 

LET BUI, Jl) =B<I1-1, Jl) 

LET BU1-1, Jl)=16 

LET 11=11-1 

GOTO 7 00 

IF 11=4 GOTO 490 

LET BUI, Jl) =B(I1 + 1, Jl) 

LET B(I1+1,J1)=16 

LET 11=11+1 

GOTO 7 00 

IF Jl=l GOTO 490 

LET B(I1,J1)=BU1, Jl-1) 

LET B(I1, Jl-l)=16 

LET J1=J1-1 

GOTO 700 

IF Jl = 4 GOTO 490 

LET BUI, Jl) =B(I1, Jl+1) 

LET BUI, Jl+l)=16 

LET J1=J1+1 

NEXT Q 



PRINT BOARD 

LET M9=0 

: OUTPUT A "HOME UP" 
PRINT CHR$ (16) ; 
PRINT " 

FOR 1=1 TO 4 

FOR J4 TO 4 

PRINT": 

IF B(I, J) =16 PRINT " 



0820 

0830 

0840 

0850 

0860 

0870 

0880 

0890 

0900 

0910 

0920 

0930 

0940 

0950 

0960 

0970 

0980 

0990 

1000 

1010 

1020 

1030 

940 

1040 

1050 

1060 

1070 

1080 

1090 

1100 

1110 

1120 

1130 

1140 

1150 

1160 

1170 

1180 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

1260 

1270 

1280 

1290 

1300 

1310 

1320 

1330 

1340 

1350 

1360 

1370 

1380 

1390 

1400 

1410 

1420 

1430 

1440 

1450 

1460 

1470 



IF BU, J)<10 PRINT " " ; 
PRINT E(I, J) ; 
NEXT J 
PRINT " : " 

PRINT " 

NEXT I 

ERASE REST OF SCREEN AND 
BEEP FOR INPUT 

PRINT CHR$ (22) ;CHR$ (7) ;CHR$ ( 7 } ; 

INPUT MOVE 

INPUT "MOVE WHICH PIECE",M 

LET I1=0:J1=0 

FOR 1=1 TO 4 

FOR J=l TO 4 

IF BU,J)=M THEN I1=I:J1=J 

NEXT J 

NEXT I 

IF 11=0 THEN PRINT "I CAN'T FIND THAT NUMBER": GOTO 

LET I2=0:J2=0 

FOR 1=11-1 TO 11+1 

IF I>4 GOTO 1090 

IF I<1 GOTO 1090 

IF BU,J1)=16 THEN 12 = 1 : J2=J1 : GOTO 1170 

NEXT I 

FOR J=J1-1 TO Jl+1 

IF J>4 GOTO 1140 

IF J<1 GOTO 1140 

IF B(I1,J)=16 THEN 12=11 : J2=J :GOTO 1170 

NEXT J 

LET M9=M9+1 

PRINT "NOT A VALID MOVE" :GOTO 940 

LET B<I2,J2)=M 

LET B{I1,J1)=16 

ON T GOTO 1210, 1320 

SEQUENTIAL SOLUTION 

LET C=0 

FOR 1=1 TO 4 

FOR J=l TO 4 

IF B(I,J)<C GOTO 720 

LET C=B(I,J) 

NEXT J 

NEXT I 

PRINT "YOU GOT IT! " 

GOTO 14 50 

MAGIC SQUARE SOLUTION 
CHECK 

FOR 1=1 TO 4 
FOR J=l TO 4 

IF B(I,J)oM(I ( J) GOTO 72 
NEXT J 
NEXT I 

A WIN IS DECLARED! 

PRINT "THAT IS THE CORRECT SOLUTION!" 
INPUT "LIKE TO PLAY ANOTHER GAME", IS 
IF LEFTS (IS, 1) ="Y" THEN RUN 
END 



' ; :GOTO 84 
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LISTING 2 



PROCEDURE numbersquare 
BASE 1 

(* version 4.0 - 12 NOV 79 
(* Marc I. Leavey, MD 

(* Basic09 version By Bob Devries April 91 
DIM t : INTEGER 
DIM i, j : INTEGER 
DIM b(4,4> : INTEGER 
DIM il, jl: INTEGER 
DIM q r m,m9,C: INTEGER 
DIM mm {4, 4) : INTEGER 
DIM lop: BOOLEAN 
DIM valid: BOOLEAN 
DIM solution: BOOLEAN 
DIM newgame : BOOLEAN 
SHELL "tmode -pause" 
newgame=TRUE 
WHILE newgame=TRUE DO 
PRINT CHR$ (12) ; 
PRINT "NUMBER SQUARES" 

PRINT " » 

PRINT 

PRINT "Welcome to the world of" 

PRINT "confusion. There are two" 

PRINT "versions of number squares:" 

PRINT " 1 - sequential" 

PRINT " 2 - Magic Square" 

INPUT "Which is your pleasure ? ",t 

IF t=l THEN 

RUN setupssbfb, il, jl) 
ELSE 

RUN setupmsb(b,mm, il, jl) 
END IF 

PRINT "I am now scrambling the board..." 
FOR q=l TO 200 
lop^FALSE 

WHILE lop=FALSE DO 
m^l + RNDO) 
IF m=l THEN 

IF ilol THEN 

b(il, jl)=b(il-l, jl) 
b<il-l, j 1) =16 
il=il-l 
lop=TRUE 
END IF 
ENDIF 
IF m=2 THEN 

IF il<>4 THEN 

b(il, jl)=b<il+l, jl) 
b(il+l, jl)=16 
il=il+l 
lop^TRUE 
ENDIF 
ENDIF 
IF m=3 THEN 

IF jlol THEN 

b(il, jl)=b(il, jl-1) 
b(il, j 1-1 } =16 
jl=jl-l 
lop=TRUE 
ENDIF 
ENDIF 
IF m=4 THEN 

IF jl<>4 THEN 

b(il, jl) =b(il, jl+1) 
b(il, jl+1) =16 
jl=jl+l 
lop=TRUE 
ENDIF 
ENDIF 
ENDWHILE 
NEXT q 

(* print board line 720 
solut ion=FALSE 
REPEAT 
m9 = 
RUN gfx2 ( "cwarea",29, 12,22, 12) 

PRINT " 

FOR i=l TO 4 
FOR j=l TO 4 
PRINT " : " ; 



IF b(i, j )=16 THEN 

PRINT " " ; 
ELSE 

IF b(i, j )<10 THEN 

PRINT " " ; 
ENDIF 

PRINT b(i, j ) ; 
ENDIF 
NEXT j 
PRINT " : " 

PRINT " " 

NEXT i 

(* input move 
valid=FALSE 
WHILE valid=FALSE DO 
il = 
jl = 
WHILE il=0 DO 

RUN gfx2("bell") 

INPUT "Move which piece ? ",m 

IF m=0 THEN 

RUN gfx2 ("cwarea" , 0, 0, 8 0,24) 
PRINT CHR$ (12) 
SHELL "tmode pause" 
END 
ENDIF 

FOR i=l TO 4 
FOR j=l TO 4 

IF b(i,j)=m THEN 
il = i 

jl = j 
ENDIF 
NEXT j 
NEXT i 
IF il=0 THEN 

PRINT "I can't find that number" 
ENDIF 
ENDWHILE 
i2 = 
j2 = 
FOR i=il-l TO il+1 

IF i>=l AND i<=4 THEN 
EXITIF b(i, il) =16 THEN 
i2 = i 
j2 = jl 

valid^TRUE 
ENDEXIT 
ENDIF 
NEXT i 

IF valid=FALSE THEN 
FOR j=jl-l TO jl+1 

IF j>=l AND j<=4 THEN 
EXITIF b(il, j)=16 THEN 
i2 = il 
J2 = j 

valid=TRUE 
ENDEXIT 
ENDIF 
NEXT j 
ENDIF 

IF valid=FALSE THEN 
m9=m9+l 

PRINT "Not a valid move" 
ENDIF 
ENDWHILE 
b(i2, j2)=m 
b(il, jl>=16 
IF t=l THEN 
c = 

FOR i=l TO 4 
FOR j=l TO 4 

IF b{i,j><c THEN (* reprint board 

solution=FALSE 
ENDIF 
c=b(i, j) 
NEXT j 
NEXT i 

IF solution=TRUE THEN 
PRINT "You got it ! " 
ENDIF 
ENDIF 

IF t=2 THEN 
FOR i=l TO 4 
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FOR j=l TO 4 

IF b(i,j )<>mm(i, j) THEN {* reprint board 

solution=FALSE 
END IF 
NEXT j 
NEXT i 
IF solution=TRUE THEN 

PRINT "That is the correct solution!" 
END IF 
END IF 
UNTIL solution=TRUE 

INPUT "Like to play another game ? ", i$ 
IF LEFTS { i$, l)="n" THEN (* rerun game 

newgame= FALSE 
END IF 
ENDWHILE 

RUN g£x2 ("cwarea", 0,0,80,24) 
SHELL "tmode pause" 
END 
0DE8 

PROCEDURE setupssb 
BASE 1 

PARAM b(4,4) : INTEGER 
PARAM il, jl : INTEGER 



by Bob'Devries 



DIM i , j : INTEGER 
FOR i=l TO 4 
FOR j=l TO 4 

b(i, j)=(i-l) *4 + j 
NEXT j 
NEXT i 
il = 4 
jl = 4 
00F2 

PROCEDURE setupmsb 

BASE 1 

PARAM b(4,4),mm(4,4): INTEGER 

PARAM il,jl: INTEGER 

DIM i, j : INTEGER 

FOR i=l TO 4 

FOR j=l TO 4 
READ mm ( i , j ) 
b(i, j ) =mm(i, j ) 

NEXT j 
NEXT i 
il = 4 
jl = 2 
DATA 1,6,15,8,12,11,2,5,10,13,4,3,7,16,9,14 



Northern Xposurc 

"Quality Products from North of the Border" 



OS-9/6809 Products 512K CoCo 3 

NitrOS-9 vl.22 Now Shipping! $29.95 
UltiMusE III $39.95 

UltiMusE Song Disks from $ 9,95 

Smash! arcade game $29.95 

AT Keyboard Adapter Call 

OS-9/68000 Termcap based 

VED Text Editor The Best! $62.95 

Vprint Text Formatter $62.95 

White's Speedisk Disk Defrag. $79.95 

OS-9/68000 K-Windows based 

Cribbage $21.95 

OSTerm 68K ANSI, VT100, more! $65.00 

UltiMusE-K MIDI music notation $79.95 

Free Catalogue available. 

US Funds — S & H included. 

Check or money order only. 



7 Greenboro Cres 
OTTAWA ON KIT 1W6 
Canada 
(613)736-0329 



€B% Scripture 



King James Version 
Concordance 
Multi-Word Search 
User Friendly 
Context Feature 
Automatic Lookup 
Fast (Sub-Second) 



<3MB Disk Space 
<300KB RAM Space 
Search Limits 
Source Code 
Encoded Data Files 

Cost $49.00 US +S/H 



CDI Bci/ie 



Simplicity of Basic 

Structure of Pascal 

Power of C 

Utility of Assembler 

Macros 

User Functions 

Intermixed Assem 

Control Structures 

Pointer Variables 



C Compatable Fens 
Dynamic Mem Bufs 
Named Constants 
Named Variables 
Named Labels 
Cost: 

$850.00 US Com/Ind 
$350.00 US Personal 
$99.00 US "LITE" 



Computer Pe/iqn lob 

RR1 Box 36 Rhineland, MO 65069 (314) 236-4373 
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"Sculptor was 

extremely easy to learn. 

We created usable code in the first week. 

All we had to do 

was build the database 

and Sculptor generated basic code for us." 

Jim Patterson 
Software Applications Engineer/Confertech International 
Conference calling system running Sculptor on OS-9 



Sculptor 4GL+SQL Application Development System 

• Extremely small memory usage • Program generator • Data query • Data dictionary • Report generator • Screen 
painter • Absolute portability-no conversion or recompiling required! • The premier database for OS-9. 



SCULPTOR 

* 4QL+SQL Application Development System 



Distributed in the US and Canada exclusively by 

The KD Consulting Group •5768'FairridgeiLrr Hamilton, Ohio 45011 
S00) 837-1619 or +1 513 887-0337 • Fax: (513) 887-0338 • Internet: sales@sculptor.com 
^allfor information and free full-system demo. 




Your 

Ad 
Could 

Go 
Here! 



ine world of 68' micros 



Supporting 

Tandy Color Computer Disk BASIC, 

CoCo OS-9, and 

OS-9/68000 



Subscriptions : 
$25/yearUS 
US$32/year Canada/Mexico 



Published by: 

FARNA Systems 

P.O. Box 321 

Warner Robins, GA 31099-0321 

Phone 912-328-7859 

Internet: dsrtfox@delphi.com 
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Programming with Solder 



This new column will appear from time to time as material is available* Pri- 
marily it will consist of hardware projects for the Color Computer, though 
submissions for other hardware that uses OS-9 are very welcome* Skill level 
required for assembling these projects will vary with the project. 



AT Keyboard to CoCo Interface by Dana Peters 



INTRODUCTION 

Overview 

Want a "real" keyboard for your CoCo? Here are plans 
for a project to construct an interface to let you use an 
IBM "AT" keyboard with your CoCo. For those who 
have re-packaged their hardware inside of a PC case, this 
is the perfect way of making your machine more useable 
and professional looking. 

The interface connects to the CoCo via the standard key- 
board connector. Because it emulates a real CoCo 
keyboard at the hardware level, no special software driv- 
ers are required. This also ensures the AT keyboard will 
work with all software, even those programs which 
access the hardware directly (many do). 

Besides providing ordinary keyboard facilities, the inter- 
face also sports a few extra features. The extra AT 
keyboard keys can be used as programmable macro keys. 
The macros can be re-deflned at any time using the key- 
board, and are stored indefinitely. The ability to reset the 
computer via the CTRL ALT DELETE key sequence is 
also provided. 

This interface should be usable by all models of CoCo (I, 
II, and III). Any IBM-compatible "AT" keyboard should 
work. Please note that the older 84-key XT keyboards are 
not supported. 

Background 

There have been many attempts at improving the CoCo 
keyboard over the years. The original CoCo shipped with 
what was dubbed a "chicklet" keyboard from the resem- 
blance of the keys in size and texture to the chewing gum 
by the same name. Universally hated, several companies 
such as Spectrum Projects, Key Tronic, Micronix, Mark 
Data, and HJL supplied replacement keyboards which 
provided a much more professional feel. Tandy's sup- 
plied much improved keyboards with the CoCo II and III, 
but was still molded into the case rather than being 
detachable. Many CoCo owners (particularly ones who 
fancied putting their CoCo into a PC case) made their 
keyboards detachable by grafting a cable between the 



keyboard and motherboard. There where also attempts at 
hooking PC keyboards to the CoCo. OWL- Ware produced 
an AT keyboard interface for the whopping price of $1 19 
US, keyboard not included! (from Rainbow magazine, 
January 1989, page 69). There is also plans for an interface 
by Bob Puppo which I have not personally seen. From 
what I've heard, it works only with XT style keyboards, 
and is relatively complex. 

CONSTRUCTION 

Theory of Operation 

The central part in this design is the Motorola HC 1 1 micro- 
controller. It essentially is an 8-bit computer on a chip. 
There are many versions of the HC 1 1 , but the 
MC68HC71 1D3 has the following goodies: 

* 192 bytes internal RAM 

* 4K internal EPROM 

* asynchronous and synchronous serial controllers 

* 2 general purpose 8-bit I/O ports 

* timer system controlling an 8-bit I/O port 

The HC1 1 has many options and abilities I won't go into, 
but suffice it to say that it is a very capable chip that can 
"do it all" letting you design circuits with very low chip 
count. It's a shame this project can't take advantage of all 
the HC1 1 has to offer, but with so many diverse options, 
using them all would be difficult! 

To emulate the CoCo keyboard matrix, the Mitel 8808 has 
been employed. This chip is intended to be used to switch 
analog telephone calls, but its 8x8 switching matrix is per- 
fect for this application. This could be done with a number 
of digital chips instead, but the single chip solution allows 
for a simpler design. 

The X25040 is an EEPROM which can provide non-vola- 
tile storage for 512 bytes of data. This is used to store 
programmable macrokey sequences. 
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Parts 



Number 


Manufacturer 


Package 


Description 


MC68HC7UD3FN 


Motorola 


48 pin DIP 


8 bit microcontroller 


MT8808AE 


Mitel 


28 pin DIP 


8x8 analog switch 


MC34064 


Motorola 


TO-92 


Low voltage inhibit 


X25040 


Xicor 


8 pin DIP 


512byteEEPROM 



The AT keyboard interface requires one of each of the chips in the above table. 

Pinouts 

Here are the pinouts of the various components. Please note that these are shown from the bottom of the chips. 



1 


EV SS 


16 


PDO 


31 


NC 


2 


V ss 


17 


PD1 


32 


PB7 


3 


PCO 


18 


NflSO 


33 


PB6 


4 


PCI 


19 


MOSI 


34 


PBS 


5 


PC2 


20 


SCK 


35 


PB4 


6 


PC3 


21 


*ss 


36 


PB3 


7 


PC4 


22 


V DD 


37 


PB2 


8 


PCS 


23 


PA7 


38 


PB1 


9 


PC6 


24 


PA6 


39 


PBO 


10 


PC7 


25 


PAS 


40 


MODB 


11 


*XIRQ 


26 


PA4 


41 


MODA 


12 


PD7 


27 


PA3 


42 


E 


13 


PD6 


28 


PA2 


43 


EXTAL 


14 


PRESET 


29 


PA1 


44 


XTAL 


15 


*IRQ 


30 


PAO 







39 D41 a 

37 a 38 D 
35c36a 
33a34Q 
31 D32D 



4042 442 4 6 

a a a □ a a 
43 1 3 5 

d a a c DgD 



a ion 9 
a 12D 11 
a 140 13 
a 16a 15 



29 D30D D D D D D 19a 17 
27 25 23 21 

C D □ a D D 

28 26 24 22 20 18 



44-PIN PLCC SOCKET (BOTTOM) 




Vcc C 


8 


1 : 


•HOLD c 


7 


2 c 


SCK d 


6 


3 : 


SI L 


5 


4 : 



*cs 
so 

*WP 
Vee 



X25040 



♦Reset 

In 

Grd 

MC34064 



1° 

o 

,0 



MT8808AE 



MOTD 



Page 23 



Issue #4, 1995 



Programming with Solder 



Schematic 

All resistors 10K unless otherwise marked. 
Pins not on diagram are No Connection. 



I_ 



10M 



8.0 MHz 
~22pF 



MC68HC711D3FN 

EXTAL 



Xtal 



22 pF 




•Reset 



PA3 



PA6 



PBO 
PB1 
PB2 
PB3 
PB4 
PB5 
PB6 
PB7 



MT8808AE 



r 



Reset 



Strobe 

Vee 

AXO 
AX1 
AX2 
AYO 
AY1 
AY2 
Data 



YO 
Yl 
Y2 
Y3 
Y4 
Y5 
Y6 

XO 
XI 
X2 
X3 
X4 
X5 
X6 
X7 



SEE SECTION "COCO 

Keyboard Connection" 



Rl 
R2 
R3 
R4 
R5 
R6 
R7 

CI 
C2 
C3 
C4 
C5 
C6 
C7 
C8 



See section "PC 
Keyboard Connection" 




See section "Reset 
Connection" 



See section "Power 
Connection" 
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CoCo Keyboard Connection 

In this section I assume that you are connecting to an "F" 
board CoCo I, CoCo II or CoCo III, which all have the 
mylar film connector for the keyboard. To connect to 
interface to the computer's keyboard port, I recommend 
using a row of staking pins which can be plugged into the 
mylar keyboard connector. 



Pin 


Desc 


1 


Rl 


2 


R2 


3 


NC 


4 


R3 


5 


R4 


6 


R5 


7 


R6 


8 


R7 


9 


CI 


10 


C2 


11 


C3 


12 


C4 


13 


C5 


14 


C6 


15 


C7 


16 


C8 



Here is the CoCo's 
keyboard connector 
looking down from 
the top of the board: 



CZ 




nz 


2 


nz 


3 


nz 


4 


□ 


5 


□ 


6 


cz 


7 


cz 


8 


cz 


9 


cz 


10 


cz 


11 


nz 


12 


cz 


13 


nz 


14 


cz 


15 


nz 


16 



Front 



Back 



PC Keyboard Connection 

The PC keyboard connects a 5-pin DIN connector. Radio 
Shack supplies a cabinet mount connector. Here is the 
pinout looking at the back of the cabinet mount connector 
for ease of wiring: 



Pin 


Desc 


1 


Clock 


2 


Data 


3 


NC 


4 


Ground 


5 


+5V 




Power Connection 

All that the interface and AT keyboard need is +5V; where 
you get it is up to you. If you have your CoCo inside of a 
PC case, I suggest taking power from an extra floppy 
power connector you're likely to have. If not, then steal the 
power from any convenient place on the CoCo mother- 
board. Use medium gauge wire from the power supply to 
the interface board and the interface board to the PC key- 
board to avoid a voltage drop. The 2.2aeF capacitor should 
bridge the supply lines where they enter the interface 
board. I suggest you verify with a voltage meter that what 
you think you've connected to +5V is actually +5V. 

Reset Connection 

To allow the CoCo to be reset from the keyboard, a wire 
must be run to the non-grounded side of the CoCo's reset 
button. Conveniently, this is available on the top side of 
the board on most CoCos, right on the reset switch itself. 

OPERATION 

Keymaps 

If you take a close look at both a CoCo and AT keyboard, 
you will soon realize that there is a distinct difference in 
the layout of non-alphabetic keys. Because of this, the 
adapter supports two different modes of operation: PC 
key map and CoCo key map. The two modes can be tog- 
gled between using the SCROLL LOCK key. When the 
SCROLL LOCK LED is off, the adapter is in PC keymap; 
when it is on, CoCo keymap is in effect. 

In PC keymap, the adapter maps the keys based what is 
printed on the AT keyboard's keycaps. For example, 
pressing SHIFT 2 will generate the @ character. When in 
CoCo keymap, pressing the same keys will generate the " 
character. The CoCo keymap maintains a one-to-one cor- 
respondence of PC keys with CoCo keys based partly on 
their physical layout. This is useful for games which 
depend on the CoCo's layout of keys, or for users who 
can't quite teach their fingers a different key layout. 

Num Lock 

The NUMLOCK key toggles the state of the correspond- 
ing keyboard LED, and changes the behavior of the 
keypad keys. When the NUMLOCK LED is on, the key- 
pad keys behave the same as the keys "0"-"9" and ".". 
When NUMLOCK is off, the keypad keys behave the 
same as the arrow keys and macro keys to the keypad's 
immediate left. 

Caps Lock 

In PC keymap mode, pressing the CAPSLOCK key tog- 
gles the keyboard's caps lock state. While the keyboard's 
caps lock is on, the adapter will automatically press 
SHIFT whenever an alphabetic character is typed. Note 
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that this doesn't affect the computer's caps lock state. 
Press SHIFT CAPSLOCK (RSDOS) or CTRL (OS9) to 
toggle the computer's caps lock state. 
Note that keyboard caps lock is not effective in CoCo 
keymap mode. Use SHIFT to toggle RSDOSs caps 
lock state while in CoCo keymap mode. 

Macro Keys 

One of the best features of this adapter is it's ability to use 
the extra keys on the AT keyboard as macro keys. A pre- 
recorded sequence of keystrokes can be associated with 
each macro key. The sequence is re-played whenever the 
key is hit. This is especially useful for commonly used 
commands, and for defining application specific key 
combinations for the named keys such as INSERT and 
PAGE UP. The macro sequences are re-definable at any 
time through the keyboard, and are saved indefinitely. 
Each of the 16 available macro keys can have up to 32 
keystrokes stored. The sequence is stored exactly as 
typed, including overlapping keystrokes (one key held 
down while another is pressed). The timing of keystrokes 
is not stored, so the keys are replayed at a fixed rate 
regardless of the delay between keystrokes when 
recorded. 

The macro keys are Fl through FIO, and the keys 
INSERT, DELETE, HOME, END, PAGE UP, and 
PAGE DOWN. To define a macro key, perform the fol- 
lowing steps: 

1 . Press SHIFT MACROKEY. 

2. Type the sequence of characters to be recorded. 

3. Press SHIFT MACROKEY again. 

The macro keys pressed in the first and third steps must 
match for the sequence to be stored (as a guard against 
accidentally re-defining a macro). You cannot use macro 
key while recording another macro. An attempt to do so 
will stop the recording. The recording will also stop if the 
sequence exceeds 32 bytes in length. To erase a macro, 
simply press SHIFT MACROKEY twice to record a null 
macro. 

To play a macro, press MACROKEY. The keys are 
played back at a pre-determined rate which cannot be 
adjusted. The playback is not affected by the state of the 
keyboard caps lock when invoked; the state of the key- 
board caps lock is significant only when the macro is 
recorded. In contrast, the state of the CoCo caps lock does 
not affect the recording, but it is significant when the 
macro is played back. 

Note that while recording a macro, it is best to avoid key 
roll-over in order to reduce the number of bytes needed to 
store the macro. Roll-over occurs when while typing 
quickly you press a second key before releasing the first 
one. Because of how the keys are stored when a macro is 



recorded, a two key sequence without roll-over takes 2 
bytes, where as with roll-over, the same sequence takes 4 
bytes. The 32 byte limit is exceeded much more easily if 
overlapping key sequence information is unnecessarily 
stored due to roll-over. As a rule of thumb, type slowly 
when recording macros. 

Keyboard Reset 

Another desirable feature of the adapter is the ability to 
reset the CoCo via the "three finger salute," the "Vulcan 
nerve pinch," or CTRL ALT DELETE key combination. 
Pressing these three keys will cause the CoCo to be reset. 

Pressing SHIFT CTRL ALT DELETE causes the adapter 
to hold down the CoCo's CTRL and ALT keys while reset- 
ting. This is useful for forcing a cold restart on the CoCo 

m. 

NOTES FROM THE AUTHOR 

I hope that many people in the CoCo community have as 
much fun building this interface as I've had designing it. I 
encourage you to send your questions, comments, and 
greetings to me via email at the address 
Dana_Peters@Mitel.COM (use ai 745 @Freenet. Carle- 
ton. C A if that fails for some reason), or by mail: 

Dana Peters 
#7-49 Sherway Drive 
Nepean, Ontario 
Canada K2J 2K3 

I had recently completed an HC11 based AT keyboard 
interface for my Amiga, and thought that it wouldn't be 
much work to adapt it for use on the CoCo. Enthusiastic 
feedback from the network lead me to complete the project 
and produce this document. If you're reading this, you've 
probably come up with a hardware hack or two on your 
machine. I'd like to encourage you to document your work 
(no matter how small), and make it available to the 
community. 
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AT KEYBOARD TO COCO INTERFACE (c) 1995 DANA PETERS 

Note: Both Kit (PCB, pre-programmed 6811 and other components) and Assembled versions of this project will be 
available from Northern Xposure beginning in early October. Call for pricing and availability. For those who wish to 
pursue construction of the project on their own, you can get a 681 1 programmed with the software by mailing it to Dana 
Peters with $5.00 to the above address. 

Top and bottom printed circuit board layouts (two-times actual size) appear below. 
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by Chris Perrault 



The Users Group is undertaking a project to establish a centralized OS-9 
information resource, containing data ranging from OS-9 Users to Bulletin 
Boards to Vendors. This information will be available to both individual 
and corporate Users Group members for a nominal charge. The co-ordinator 
for this project is Chris Perrault. 



Vendor Information 



In this, our fourth installment of the OS-9 Users' Group 
Sourcebook series, we will take a look at a major force 
behind the OS-9 community. Those who sell hardware, 
software, books, and magazines, related to OS-9, play a 
very crucial role in our advancement as a legitimate mar- 
ket. If we don't have these vendors, we are effectively 
non-existent. If you are a company that sells OS-9 related 
products and services, whether for personal or industrial 
use, then please fill out and return the form that follows 
this article. 

A Little Background 

Since OS-9 first made it's appearance in the personal 
computing market back in the mid 80's, third party ven- 
dor support is what has kept it as a viable system choice. 
In the present era, the number of companies supporting 
OS-9 has dwindled but new ones still pop up to replace 
those that have gone under. The companies that remain 
are still very active and bring new products to OS-9 users 
regardless of the fact that the userbase is not the size of 
many in the more mainstream communities. In order to 
keep business for the vendors healthy, it is up to US the 
USERS to support them by continuing to buy their prod- 
ucts, and to communicate with them about what you 
would like to see. Many a company has gone under in the 
past due to lack of customer participation, and it is the 
hope of us the OS-9 UG that such participation will 
increase and users will begin to show their appreciation 
even more with their patronage. 

On The Other End... 

There is also an obligation on the part of the companies 
selling OS-9 related products. In order to continue user 
confidence and to gain even more of it, you will have to 
hold up your end of the bargain and meet the users needs 
on various levels. Getting orders shipped in a timely man- 
ner, having the actual product in stock BEFORE taking 
checks, developing a high standard for your products, 
along with communicating with your customers on a reg- 
ular basis, especially in the event that a there may be 



problem with the product or it's availability are key issues 
and it is important that vendors adopt a standard they can 
maintain in addressing them. Traditionally OS-9 vendors 
have been very good about this in the past, but with such a 
small scale market to deal with, it does get harder to busi- 
nesses to meet these needs in the present era. Without a 
proper balance of support from both the users and the com- 
panies, prosperity in this community becomes that much 
more uncertain, and it doesn't take a lot to throw things off. 
Through the sourcebook it is our intention to help vendors 
by keeping users aware of their presence and where to find 
them, and to also assist in helping vendors find the poten- 
tial customers. This kind of communication is key in 
helping to establish a healthy business-community rela- 
tionship. We ask ALL OS-9 based businesses to fill out 
and return the supplied entry form, regardless of whether 
or not you are a UG member. We don't want ANYONE to 
miss out on this opportunity. 

Where Can I Find OS-9 Vendors? 

The first place you can look to find OS-9 businesses is 
right here in this issue of the MOTD. Every issue includes 
a listing of vendors with addresses and phone numbers, 
including those that are corporate members supporting the 
UG. Also many will advertise in the MOTD, plus other 
publications that support OS-9 such as 'the world of 68 
micros', so be sure to subscribe to at least one OS-9 related 
publication, since they also have some pretty good reading. 
A list of publications is also included with each issue of the 
MOTD. Very importantly, coming up on the weekend of 
September 30 and October 1st will be the Atlanta Fest, 
where you will be able to meet OS-9 vendors from all over 
the nation and buy some of their new and not so new prod- 
ucts 'live' and in 'real time'. More information regarding the 
Atlanta Fest is available elsewhere in this issue if you 
interested are in attending. If you can make the trip you are 
strongly encouraged to do so and show your encourage- 
ment to the vendors and organizations that like us the users 
help keep OS-9 going! 



Entry Level C 



Jim Vestal's Entry Level C column will return next issue. 



bv Jim Vestal 
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